home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / src / exampleCode / opengl / GLUT / README.xinput < prev   
Text File  |  1996-11-11  |  8KB  |  263 lines
  1.  
  2. GLUT NOTE:  The GLUT API version 2 & 3 X11 implementations support the SGI
  3. Dials and Buttons, SGI Spaceball, and SGI Tablet via the X Input
  4. extension.  These devices are advertised as described below.  If other
  5. vendors advertise these X Input extension devices differently, GLUT's X
  6. implementation will need to be extended to properly support such
  7. differently advertised devices.
  8.  
  9.  
  10.     X Input Extension Devices as Advertised by Silicon Graphics
  11.  
  12.                             Mark Kilgard
  13.  
  14.                          February 13, 1995
  15.  
  16.                              $Revision: 1.1 $
  17.  
  18. This document describes how Silicon Graphics Inc. (SGI) advertises its
  19. support for input devices through the X Input extension.  Because the X
  20. Input extension only provides mechanism for supporting additional X
  21. input devices, vendors may support the same or similar devices in
  22. slightly different ways making it difficult for programs to count on
  23. how a given input device will be supported across vendors.
  24.  
  25. The intent of this document is not to propose any standard way of
  26. supporting specific X Input extension devices, but merely to thoroughly
  27. describe SGI's X Input support for the benefit of X Input programmers
  28. and other X Input extension implementors wishing to mimic SGI's X Input
  29. support to avoid needless incompatibility for otherwise standard and
  30. common input devices.
  31.  
  32. The client queriable state returned by the X Input extension is not
  33. enough to effectively use X Input extension devices.  The physical
  34. layout of how the dials, axes, buttons, etc. are laid out is not
  35. queriable.  Effective use of the extension requires knowledge of the
  36. physical layout of the devices.  Diagrams are provided to show the
  37. actual layout.
  38.  
  39. Comments and corrections should be sent to Mark Kilgard <mjk@sgi.com>
  40.  
  41. SGI Dials and Buttons:
  42.  
  43.   Device type:                    KNOB_BOX
  44.   Device name:                    dial+buttons
  45.   Classes:                        2
  46.     ButtonClass
  47.       Number buttons:             32
  48.     ValuatorClass
  49.       Device mode:                Absolute
  50.       Number axes:                8
  51.     Axis 1
  52.       Minimum value:          -32768
  53.       Maximum value:          32767
  54.       Resolution:             200
  55.     Axis 2
  56.       Minimum value:          -32768
  57.       Maximum value:          32767
  58.       Resolution:             200
  59.     Axis 3
  60.       Minimum value:          -32768
  61.       Maximum value:          32767
  62.       Resolution:             200
  63.     Axis 4
  64.       Minimum value:          -32768
  65.       Maximum value:          32767
  66.       Resolution:             200
  67.     Axis 5
  68.       Minimum value:          -32768
  69.       Maximum value:          32767
  70.       Resolution:             200
  71.     Axis 6
  72.       Minimum value:          -32768
  73.       Maximum value:          32767
  74.       Resolution:             200
  75.     Axis 7
  76.       Minimum value:          -32768
  77.       Maximum value:          32767
  78.       Resolution:             200
  79.     Axis 8
  80.       Minimum value:          -32768
  81.       Maximum value:          32767
  82.       Resolution:             200
  83.  
  84.   Physical layout:
  85.  
  86.        +---------+
  87.        | (7) (8) |
  88.        |         |
  89.        | (5) (6) |
  90.        |         |   <---- Dials on dial box w/ axis number
  91.        | (3) (4) |
  92.        |         |
  93.        | (1) (2) |
  94.        +---------+
  95.  
  96.        +-------------------------------+
  97.        |      [ 1] [ 2] [ 3] [ 4]      |
  98.        |                               |
  99.        | [ 5] [ 6] [ 7] [ 8] [ 9] [10] |
  100.        |                               |
  101.        | [11] [12] [13] [14] [15] [16] |  <--- Buttons on button box
  102.        |                               |       w/ button number
  103.        | [17] [18] [19] [20] [21] [22] |
  104.        |                               |
  105.        | [23] [24] [25] [26] [27] [28] |
  106.        |                               |
  107.        |      [29] [30] [31] [32]      |
  108.        +-------------------------------+
  109.  
  110.   Device manufacturer:            Seiko
  111.  
  112. SGI SpaceBall:
  113.  
  114.   Device type:                    SPACEBALL
  115.   Device name:                    spaceball
  116.   Classes:                        2
  117.     ButtonClass
  118.       Number buttons:             9
  119.     ValuatorClass
  120.       Device mode:                Absolute
  121.       Number axes:                7
  122.     Axis 1
  123.       Minimum value:          -18000
  124.       Maximum value:          18000
  125.       Resolution:             200
  126.     Axis 2
  127.       Minimum value:          -18000
  128.       Maximum value:          18000
  129.       Resolution:             200
  130.     Axis 3
  131.       Minimum value:          -18000
  132.       Maximum value:          18000
  133.       Resolution:             200
  134.     Axis 4
  135.       Minimum value:          -18000
  136.       Maximum value:          18000
  137.       Resolution:             200
  138.     Axis 5
  139.       Minimum value:          -18000
  140.       Maximum value:          18000
  141.       Resolution:             200
  142.     Axis 6
  143.       Minimum value:          -18000
  144.       Maximum value:          18000
  145.       Resolution:             200
  146.     Axis 7
  147.       Minimum value:          -18000
  148.       Maximum value:          18000
  149.       Resolution:             200
  150.  
  151.   Physical layout:
  152.  
  153.      +-----------------+
  154.      | [1] [2] [3] [4] |   <---  Function keys
  155.      | [5] [6] [7] [8] |
  156.      |                 |
  157.      |    /--[9]--\    |   <---  Pick button (hidden on ball surface)
  158.      |   /         \   |
  159.      |  |  "the     |  |         Axes 1-3   X, Y, Z rotation
  160.      |  |   ball"   |  |         Axes 4-6   X, Y, Z translation
  161.      |  |           |  |         Axis 7     Period
  162.      |   \         /   |
  163.      |    \-------/    |         X is left and right; Y is up and down;
  164.      |                 |         Z is back and forward.
  165.      +-----------------+
  166.  
  167.   Device manufacturer:            SpaceBall Technologies, Inc. Lowell, MA
  168.                   (508) 970-0330.
  169.  
  170. SGI Tablet:
  171.  
  172.   Device type:                    TABLET
  173.   Device name:                    tablet
  174.   Classes:                        2
  175.     ButtonClass
  176.       Number buttons:             4
  177.     ValuatorClass
  178.       Device mode:                Absolute
  179.       Number axes:                2
  180.     Axis 1
  181.       Minimum value:          0
  182.       Maximum value:          2206
  183.       Resolution:             200
  184.     Axis 2
  185.       Minimum value:          0
  186.       Maximum value:          2206
  187.       Resolution:             200
  188.   Physical layout:
  189.  
  190.             -----
  191.            / (+) \        The tablet puck crosshair
  192.           /   |   \
  193.          /    |    \
  194.          +---------+
  195.          |   <1>   |      The tablet puck buttons.
  196.          |         |
  197.          | <2> <4> |
  198.          |         |
  199.          |   <3>   |
  200.           \       /
  201.        +-----+
  202.  
  203.   Device manufacturer:            Hitachi
  204.  
  205. SGI Virtual Pointer:
  206.  
  207.   Device type:                    VIRTUAL_POINTER
  208.   Device name:                    virtual_pointer
  209.   Classes:                        2
  210.     ButtonClass
  211.       Number buttons:             5
  212.     ValuatorClass
  213.       Device mode:                Absolute
  214.       Number axes:                2
  215.     Axis 1
  216.       Minimum value:          0
  217.       Maximum value:          1280
  218.       Resolution:             200
  219.     Axis 2
  220.       Minimum value:          0
  221.       Maximum value:          1024
  222.       Resolution:             200
  223.   Physical layout:                n/a
  224.   Device manufacturer:            n/a
  225.   Notes:  The virtual_pointer allows multiple physical devices to "push"
  226.     a single logical pointer.  The virtual pointer is an SGI feature.
  227.  
  228. SGI Mouse:
  229.   
  230.   Device type:                    MOUSE
  231.   Device name:                    mouse
  232.   Classes:                        2
  233.     ButtonClass
  234.       Number buttons:             3
  235.     ValuatorClass
  236.       Device mode:                Absolute
  237.       Number axes:                2
  238.     Axis 1
  239.       Minimum value:          0
  240.       Maximum value:          65000
  241.       Resolution:             200
  242.     Axis 2
  243.       Minimum value:          0
  244.       Maximum value:          65000
  245.       Resolution:             200
  246.   Physical layout:
  247.     
  248.     +-------------+
  249.     |             |
  250.     | [1] [2] [3] |  <---  Buttons on mouse w/ button numbers.
  251.     |             |
  252.     |             |
  253.     |             |
  254.     |             |
  255.     +-------------+
  256.  
  257.     Axis 1 is for mouse motion in X axis (left & right)
  258.     Axis 2 is for mouse motion in Y axis (top & bottom)
  259.  
  260.   Device manufacturer:            SGI
  261.  
  262.  
  263.